v0.9.32: Version 0.9.32 - 2025-08-12

Compare Source

Version 0.9.32 - 2025-08-12

The last month has featured our team banging our collective heads against the wall as we work on tightening up the outstanding skipped tests. While there are a couple of stray parsing bugs here and there, most of it has to do with ensuring that the parsing of Markdown tokens are complete... including whitespaces. This is not an issue for generating HTML, but we feel it is a big issue for people writing rules against those tokens. As such, we are trying to ensure we capture as many scenarios as possible, and making sure all tests pass. Its often a tough job, but we feel it is worth it!

On that note, please note that if you are using pragmas to temporarily turn off rules in your documents, there is a small change. In fixing Issue 1447, we noticed there was an issue with how the pragmas ended. To fix this properly, as of release 0.9.32, pragmas starting with a <!-- must end with a --> and pragmas starting with a <!--- must end with a --->. This should be a one time change, and we apologize in advance for any issues it causes.

A big thanks to our users who are reporting issues with the project! While we would like to believe we can think of every test case, we know we cannot. Therefore, we continue to need our users to help us out. If you are scanning any Markdown documents and the results seem off, please file an issue. If you are starting to use our fix mode on your Markdown documents and there are issues, please file an issue. We appreciate any help that we can get to improve the project for everyone!

Added

• Issue 1454
  • added support for --enable-extensions to the command line and API
• Issue 1455
  • added API functions for --no-json5 and --continue-on-error to achieve parity with command line

Fixed

• Issue 1387
  • fixed weird indent issue with Md005
• Issue 1400
  • addressed issues with Md041 and how it handles HTML Block elements at the start of a document
  • added extra examples to documentation to expand on some interesting areas with the Md041 rule and "invisible" tags
• Issue 1441
  Issue 1443
  • an invalid LRD, started right after a container block was started did not unwind properly
• Issue 1446
  • multiple issues with LRDs and whitespace/tabs
• Issue 1447
  • was not handling ---> properly at the end of pragmas
• Issue 1464
  • adding better support for tabs with LRDs.

v0.9.31: Version 0.9.31 - 2025-07-11

Compare Source

Life caught up with our development team this last two months, but we finally finished the work we intended to do for this release. After spending some time to upgrade application_properties to 0.9.0, this release of PyMarkdown adopts that new version, including the simplified setup that was added to application_properties. In addition, PyMarkdown is not using the JSON5 support from application_properties and defaults to it being on. While completing that work, we also went through the configuration documentation, delegating any duplicated sections with the application_properties documentation to application_properties .

During this time, we did some internal housekeeping. We maintain a small group of packages, with common scripting and support to help our team use best practices across all packages. That had not been maintained lately, so we chose to spend a couple of weeks working on getting the packages back to where we wanted them. No effect for how you use this package, but it helps us keep things current.

A big thanks to our users who are reporting issues with the project! While we would like to believe we can think of every test case, we know we cannot. Therefore, we continue to need our users to help us out. If you are scanning any Markdown documents and the results seem off, please file an issue. If you are starting to use our fix mode on your Markdown documents and there are issues, please file an issue. We appreciate any help that we can get to improve the project for everyone!

Added

• Issue 1378
  • upgrade to latest version of application_properties, v0.9.0
  • enabled ability to use JSON5 (default) or normal JSON via command line
    switch
  • made small modifications to plugins as our team is unaware of any
    custom plugin users
    • change is to use a local MyApplicationPropertiesFacade which
      provides better abstraction
  • removed redundant configuration documentation in favor of pointing
    links at updated application_properties documentation
• Issue 1427
  • Adhering to project templates across various projects.

Fixed

• None

Changed

• None

v0.9.30

Compare Source

Version 0.9.30 - Date: 2025-04-19

Apologies for a late release, but we wanted to get some outstanding issues resolved before the release. Notable things to mention are:

• Blanket disabling and then selective enabling of rules
• New pragma disable and enabled commands
• Exclusion of specific files and glob file paths from scanning

And while it may not be visible, a lot of work has been completed on getting proper Table token support in the application. As the rules engine is largely token based, any desired rules that include tables must rely on well-tested support for the new table token. Our development team is hoping to make more progress on this in the next couple of months, and will announce it loudly when it is completed!

A big thanks to our users who are reporting issues with the project! While we would like to believe we can think of every test case, we know we cannot. Therefore, we continue to need our users to help us out. If you are scanning any Markdown documents and the results seem off, please file an issue. If you are starting to use our fix mode on your Markdown documents and there are issues, please file an issue. We appreciate any help that we can get to improve the project for everyone!

Added

• Issue 1396
  • Support for specific rule enablement
  • Disabling of all rules and then selective enabling
• Issue 1401
  • Ability to exclude files from the command line
• Issue 1403
  • Added disable and enable for pragmas

Fixed

• Issue 1379
  • Fixed rehydration issues for test_extra_052l* and test_extra_052m*
  • Precursor for addressing the fix mode Md031 tests
• Issue 1380
  • Fixing the 2 Md031 tests now unblocked from Issue 1379
• Issue 1387
  • Fixed Md005 not firing properly within alternating ordered and unordered list
• Issue 1401
  • Fixed a small issue with the ** glob characters not working properly

Changed

• None

v0.9.29: Version 0.9.29 - Date: 2025-03-10

Compare Source

The work continues! Due to our development team passing colds back and forth between members, February was a slow month in terms of progress. We plan to start adding the foundations for new leaf items in March and April, in addition to completing the current round of issues found with rule Md031's fix mode.

A big thanks to our users who are reporting issues with the project! While we would like to believe we can think of every test case, we know we cannot. Therefore, we continue to need our users to help us out. If you are scanning any Markdown documents and the results seem off, please file an issue. If you are starting to use our fix mode on your Markdown documents and there are issues, please file an issue. We appreciate any help that we can get to improve the project for everyone!

If everyone reading this can take a moment and think of our mascot, "Bruce" and any pets of their own that have moved on, it would be appreciated. He passed away this morning suddenly. Our team can honestly say that Bruce was the best rubber duck that we have ever had, and we will miss him very much.

Added

• None

Fixed

• Issue 1352
  • Fixed parsing and rehydration issues, as precursor to tackling Md031 fix issue
• Issue 1356
  • Fixed rehydration error with test test_extra_052r0.
• Issue 1358
  • Fixed rehydration error with test test_extra_053d1.
• Issue 1364
  • Fixed parsing error and rehydration error related to multiple drop
    container scenarios involving the remaining containers being lists.
• Issue 1357
  • Fixed issue with rule Md007 and nested lists
• Issue 1371
  • Fixed Md031 fix issues related to issue 1364 fixes.

Changed

• None

v0.9.28: Version 0.9.28 - Date: 2025-02-10

Compare Source

The work continues! Working through the categorized list takes time, but it is well worth it. We are also working on improving our bash and github actions infrastructure, making it easier to release the project each month.

A big thanks to our users who are reporting issues with the project! While we would like to believe we can think of every test case, we know we cannot. Therefore, we continue to need our users to help us out. If you are scanning any Markdown documents and the results seem off, please file an issue. If you are starting to use our fix mode on your Markdown documents and there are issues, please file an issue. We appreciate any help that we can get to improve the project for everyone!

Added

• Issue 1289
  • added documentation under Pre-Commit for how to write the configuration file for Pre-Commit if an alternate extension is needed for the files being scanned
• Issue 1318
  • ported perf_*.cmd scripts to perf_.sh scripts
• Issue 1320
  • added ShFmt .sh formatter to Pre-Commit configuration
• Issue 1322
  • added Shellcheck .sh scanner to Pre-Commit configuration
• Issue 1327
  • added simple mechanism to log and view performance measurements

Fixed

• Issue 1302
  • reported issue where C\# at the end of a header was triggering rule Md020 for no spaces between end mark of an Atx Heading
• Issue 1326
  • fix mode for MD012 not properly handling double lines in lists after new list indicators
• Issue 1288
  • rule Md037 and documentation updated to properly ensure that at least one of the two ends has spaces on both sides of the emphasis sequence
• Issue 1334
  • fixed SNAFU1 for MD031 fix mode, assert
• Issue 1344
  • fixed SNAFU6 for MD031 fix mode, assert
• Issue 1346
  • fixed SNAFU8 for MD031 fix mode, assert

Changed

• Issue 1277
  • Rule Md044 changed to add a code_spans exclusion as a compliment to the code_blocks exclusion.